home *** CD-ROM | disk | FTP | other *** search
/ More MacCube 1: Arcade Games / More MacCube Vol 1 Arcade Games.bin / Games⁄Arcade / Bolo / More information / Sample Code / Std Autopilot / #ReadMe.Note next >
Encoding:
Text File  |  1995-05-13  |  1.6 KB  |  37 lines  |  [TEXT/KAHL]
  1. // Bolo code (C) Stuart Cheshire <cheshire@cs.stanford.edu> 1987-1995.
  2. // All rights reserved. This code is owned by Stuart Cheshire and is donated
  3. // free of charge for non-commercial use. You may not use this code in any
  4. // product sold for commercial profit, except shareware priced at $25 or less.
  5.  
  6. BrainFrame is a tool for programmers writing Brains, to allow them to run
  7. their programs as applications with source level debugging, instead of as
  8. CODE resources, which are hard to debug.
  9.  
  10. To use BrainFrame, include your Brain's source file(s) in the project. You
  11. should also include any resource files you use. (Remove Standard Autopilot.c
  12. and Standard Autopilot.π.rsrc first).
  13.  
  14. Add the following lines at the top of your main C file (the one that defines
  15. the routine "main"):
  16.  
  17. #if !__option(a4_globals)
  18. #define main BrainMain
  19. BoloBrain BrainMain;
  20. #endif
  21.  
  22. The way this works, is if the code is being compiled as an application instead
  23. of as a CODE resource, then it won't be using A4 globals, and your routine
  24. "main" will be redefined as the name "BrainMain" so that the BrainFrame
  25. application can call it as a subroutine.
  26.  
  27. You can then run BrainFrame as an application, connect to a running Bolo tank,
  28. and control it as a normal Brain would.
  29.  
  30. WARNING: THIS IS A DEBUGGING TOOL FOR BRAIN PROGRAMMERS ONLY.
  31.  
  32. The Bolo Brain interface is due for a major overhaul, and this application
  33. interface will change. Backwards compatibility with old BBRN CODE resource
  34. files will be preserved, but this application interface will not. You can
  35. use this for testing and development, but please don't release any public
  36. applications that use this interface, or you'll have unhappy users.
  37.